-
Notifications
You must be signed in to change notification settings - Fork 24.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Use 'node_selector' for type-less yaml-tests in mixed clusters #36717
Conversation
Currently we skip yaml integration tests using the new typless API versions for all clusters where any node has a version earlier than 7.0. This effectively means we don't run this tests in mixed clusters or uphrade scenarios, which is why we also copy each test to a version "*_with_type". The integration test framework seems to have a feature where do-sections can specify that a node it is run agains has a certain version or provides certain features. We can use this "node_selector" feature to make sure we only hit nodes in version >7.0 in the yaml tests that use type-less API calls. This way we don't have to effectively disable mixed version or bwc tests and we might reduce the number of tests we need to copy using the old typed APIs to the bare minimum since we already cover most of the other testing with the new typless versions. This PR shows this with the "_explain" API as an example.
Pinging @elastic/es-search |
This can be checked e.g. with running Mainly opening this as a suggestion for discussion. My main goal would be to not having to skip all "new" types of yaml tests in mixed cluster scenarios and to be able to remove a majority of the copied "*_with_types" tests. I think it would be enough to have only a few of those left for each API to e.g. check that the deprecated enpoints still work, but we should not have to copy all specialized cases. We have a slow build anyway, which is why I'm trying to keep us from having to needlessly duplicate all those integration tests. |
I'm wondering if I'm missing something -- I'm having trouble seeing what switching to |
The way I see it, we are only excluding 6.x nodes from receiving rest requests with the new incompatible type-less format. But they are still part of the mixed cluster, so all other aspects that these tests cover, like internal serialization, responses etc... are still tested. Currently we are effectively disabling bwc and mixed cluster tests whenever we use a new typeless API, which is why we then need to add another test that still uses the typed version. With this change, I think, we can make the "new" tests the default and would need to add less of the "*_with_types" tests. Lets take the explain tests as an example. We are adding "21_source_filtering_with_types" only so that this kind of test runs in a mixed scenario, I think. What is tested here (the source filtering) isn't really affected at all by types vs. no-types except for the rest request side (which is already covered if we have typed and type-less versions in "10_basic"). Same with "31_query_string_with_types". I think the core of these tests checks functionality that isn't affected by whether we test with or without types, we only run it so we have coverage where we currently skip testing in the type-less tests. I think we are currently duplicating to much tests which is bad considering that we already have a slow build and we can do better using this approach. |
@cbuescher Thanks for the bringing up this feature. I think we should start with asking ourselves what we want to test. I think we need to test the following (please add/correct here):
For #1 and #2 we already have our current yml tests. |
Thanks @cbuescher, I was missing this part in my thinking. It sounds like one piece we wouldn't be covering in those particular tests is REST BWC. Apart from keeping everything simple + consistent, I don't have very strong opinions here, and am interested to hear what others think. One other question I had was around whether this would make it more difficult to other language clients to use these tests. I would guess that they already implement |
No, that's not what I would expect. The idea was to make the new typless API tests the default going forward, and to be able to do that we'd also make sure the things these tests cover (which usually is more than just how the rest endpoint works) is also tested in mixed cluster scenarios (like e.g. serialization, other functionality that doesn't have to do with types or rest endpoints). I was suggesting making the test covering scenarios 3 and 4 the default tests in 7.0 and only have a few special ones checking 1 and 2, since those mixed cluster scenarios should be happening on rolling upgrades and we want to move people away from the old typed APIs. Unfortunately I just learned today that the language clients also use the rest-api-spec the yaml tests are part of for their tests and most of the client test runners don't support the "node_selector" feature, which makes this whole approach somehow void since they would essentially have to skip all tests using it. Just trying to summarize my thinking here. As an aside, clicking on either #1, #2, #3 or #4 is worth a few minutes :-) |
Sorry, our comments just crossed. Exactly, I wasn't aware of these tests being used by the language clients too. |
To summarize my current thinking around this: I'd be really glad if we didn't have to basically double the amount of yaml tests for the whole duration of 7.x, but unfortunately |
I think we can close this PR for now. I can dig it up again if needed. |
Currently we skip yaml integration tests using the new typless API versions for
all clusters where any node has a version earlier than 7.0. This effectively
means we don't run this tests in mixed clusters or uphrade scenarios, which is
why we also copy each test to a version "*_with_type".
The integration test framework seems to have a feature where do-sections can
specify that a node it is run agains has a certain version or provides certain
features. We can use this "node_selector" feature to make sure we only hit nodes
in version >7.0 in the yaml tests that use type-less API calls. This way we
don't have to effectively disable mixed version or bwc tests and we might reduce
the number of tests we need to copy using the old typed APIs to the bare minimum
since we already cover most of the other testing with the new typless versions.
This PR shows this with the "_explain" API as an example.